docs/development/Building in Windows 10 with Linux Subsystem.md

   1 # Building in Windows 10 with Linux subsystem
   2
   3 Linux subsystem for Windows 10 is probably the simplest way of building INAV under Windows 10.
   4
   5 ## Setting up the environment
   6
   7 Enable WSL:
   8 run `windows features`
   9 enable `windows subsytem for linux`
  10 reboot
  11
  12
  13 Install Ubuntu:
  14 1.  Go to Microsoft store https://www.microsoft.com/en-gb/store/b/home
  15 1.  Search and install most recent Ubuntu LTS version
  16 1.  When download completed, select `Launch Ubuntu`
  17 1.  When prompted enter a user name and password which you will need to remember
  18 1.  When complete, the linux command prompt will be displayed
  19
  20 NOTE: from this point all commands are entered into the Ubunto shell command window
  21
  22 Update the repo packages:
  23 1.  `sudo apt update`
  24
  25 Install Git, Make, gcc and Ruby
  26 1.  `sudo apt-get install git`
  27 1.  `sudo apt-get install make`
  28 1.  `sudo apt-get install gcc-arm-none-eabi`
  29 1.  `sudo apt-get install ruby`
  30
  31 ## Downloading the iNav repository (example):
  32
  33 Mount MS windows C drive and clone iNav
  34 1.   `cd /mnt/c`
  35 1.   `git clone https://github.com/iNavFlight/inav.git`
  36
  37 You are ready!
  38 You now have a folder called inav in the root of C drive that you can edit in windows
  39
  40
  41 ## Building (example):
  42
  43 Launch Ubuntu:
  44 Click Windows Start button then scroll and lauch "Ubuntu"
  45
  46 Building from Ubunto command line
  47 `cd /mnt/c/inav`
  48 `make clean TARGET=OMNIBUSF4PRO` (as an example)
  49 `make TARGET=MATEKF405`  (as an example)
  50
  51
  52 ## Flashing:
  53 Launch windows configurator GUI and from within the firmware flasher select `Load firmware[Local]`
  54 Hex files can be found in the folder `c:\inav\obj`